PC World Komputer 2010 April/PCWorld0410.iso/hity wydania/Ubuntu 9.10 PL/karmelkowy-koliberek-desktop-9.10-i386-PL.iso/casper/filesystem.squashfs/usr/share/gnome-doc-utils/templates/gnome-app-template.xml

Extensible Markup Language | 2009-09-22 | 31KB | 862 lines

<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY appname          "MY-GNOME-APPLICATION">
  <!ENTITY app "<application>MY-GNOME-APPLICATION</application>">
  <!ENTITY appversion   "2.0">
  <!ENTITY manrevision  "2.0">
  <!ENTITY date "March 2002">
  <!-- Information about the entities
       Use the app and appname entities to specify the name of the application.
       Use the appversion entity to specify the version of the application.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
-->
]>
<!--
  This is a GNOME documentation template, designed by the GNOME
  Documentation Project Team. Please use it for writing GNOME
  documentation, making obvious changes, such as:
  - all the words written in UPPERCASE (with the exception of GNOME)
    should be replaced. As for "legalnotice", please leave the reference
    unchanged.
  - all id attributes should have 'myapp' replaced

  Remember that this is a guide, rather than a perfect model to follow
  slavishly. Make your manual logical and readable: see the GDP Style Guide for
  more on this.
-->
<!--
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://live.gnome.org/DocumentationProject
  Template version: 3.0 beta
  Template last modified 2006-11-21

-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
  <articleinfo>
    <title>&app; Manual</title>
    <abstract role="description">
      <para>&app; is ... <!-- insert brief description -->.</para>
    </abstract>

    <copyright>
      <year>2006</year>
      <holder>GNOME Documentation Project</holder>
    </copyright>

    <!-- An address can be added to the publisher information. -->
    <publisher role="maintainer">
      <publishername>GNOME Documentation Project</publishername>
    </publisher>

      <xi:include href="legal.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
    <!-- The file legal.xml contains link to license for the documentation,
        and other legal stuff such as "NO WARRANTY" statement.
        Please do not change any of this. -->

    <authorgroup>
      <author>
            <firstname>Documentation</firstname>
            <surname>Writer 2</surname>
            <affiliation>
                  <orgname>GNOME Documentation Project</orgname>
                  <!-- The email address of the author is optional and is commented out by default.
                <address> <email>[e-mail]</email> </address>
                -->
            </affiliation>
      </author>
      <author>
            <firstname>Documentation</firstname>
            <surname>Writer 1</surname>
            <affiliation>
                  <orgname>GNOME Documentation Project</orgname>
                  <!-- The email address of the author is optional and is commented out by default.
                <address> <email>[e-mail]</email> </address>
                -->
            </affiliation>
      </author>
    </authorgroup>


<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->
    <revhistory>
      <revision>
        <revnumber>MY-GNOME-APPLICATION Manual V&manrevision;</revnumber>
        <date>&date;</date>
        <revdescription>
              <para role="author">Documentation Writer 2
        <!-- The email address of the author is optional and is commented out by default.
            <email>[e-mail]</email> -->
              </para>
              <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>Full title of previous manual.</revnumber>
        <date>Release date of previous manual.</date>
        <revdescription>
              <para role="author">Documentation Writer 1
        <!-- The email address of the author is optional and is commented out by default.
            <email>[e-mail]</email> -->
              </para>
              <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
    </revhistory>

    <releaseinfo>This manual describes version &appversion; of MY-GNOME-APPLICATION.
    </releaseinfo>
    <legalnotice>
      <title>Feedback</title>
      <para>To report a bug or make a suggestion regarding the &app; application or
      this manual, follow the directions in the
      <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the GNOME User Guide</ulink>.
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice>
  </articleinfo>

  <indexterm zone="index">
    <primary>MY-GNOME-APP</primary>
  </indexterm>
  <indexterm zone="index">
    <primary>mygnomeapp</primary>
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
  <sect1 id="myapp-introduction">
    <title>Introduction</title>
    <para>Use &app; to view image files.
    &app; provides the following features:</para>
    <itemizedlist>
      <listitem>
        <para>Support for the following image file formats:</para>
        <itemizedlist>
              <listitem>
            <para>BMP - Windows Bitmap</para>
              </listitem>
              <listitem>
            <para>GIF - Graphics Interchange Format</para>
              </listitem>
              <listitem>
            <para>ICO - Windows Icon</para>
              </listitem>
              <listitem>
            <para>JPEG - Joint Photographic Experts Group</para>
              </listitem>
              <listitem>
            <para>PNG - Portable Network Graphics </para>
              </listitem>
              <listitem>
            <para>PNM - Portable Anymap from the PPM Toolkit</para>
              </listitem>
              <listitem>
            <para>RAS - Sun Raster </para>
              </listitem>
              <listitem>
            <para>TIFF - Tagged Image File Format</para>
              </listitem>
              <listitem>
            <para>XPM - X Pixmap</para>
              </listitem>
        </itemizedlist>
      </listitem>
      <listitem>
      <para>A variety of zoom levels and full screen viewing, with low usage
      of memory regardless of the zoom level. </para>
      </listitem>
    </itemizedlist>
    <note>
      <para>This is a note.</para>
    </note>
  </sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here.
     If the information about how to get started is very short, you can
     include it in the Introduction and omit this section. -->

  <sect1 id="myapp-getting-started">
    <title>Getting Started</title>

    <sect2 id="myapp-start">
    <title>Starting &app;</title>
    <para>You can start &app; in the following ways:
    </para>
    <variablelist>
        <varlistentry>
            <term><guimenu>Applications</guimenu> menu</term>
            <listitem>
            <para>Choose
            <menuchoice>
            <guisubmenu>Submenu Name </guisubmenu>
            <guimenuitem>My-GNOME-APPLICATION</guimenuitem>
            </menuchoice>. </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term>Command line</term>
            <listitem>
            <para>To start &app; from a command line, type the following command,
            then press <keycap>Return</keycap>:</para>
            <para>
            <command>myapp</command>
            <replaceable>filename.jpg</replaceable>
            </para>
            <para>where
            <replaceable>filename.jpg</replaceable> is the name of the file you
            want to open.
            </para>
            <para>&app; opens each file that you specify in a new window.</para>
            </listitem>
        </varlistentry>
    </variablelist>
    </sect2>

    <sect2 id="myapp-when-start">
    <title>When You Start &app;</title>
    <para>When you start &app;, the following window is displayed.</para>

    <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig">
    <title>&app; Start Up Window</title>
    <screenshot>
      <mediaobject>
        <imageobject><imagedata
        fileref="figures/myapp_start_window.png" format="PNG"/>
        </imageobject>
        <!-- EPS versions of the figures are not required at the moment. -->
            <!--
            <imageobject>
              <imagedata fileref="figures/image.eps" format="EPS"/>
                </imageobject>
        -->
        <textobject>
          <phrase>Shows &app; main window. Contains titlebar, menubar, toolbar, display area, and
          scrollbars. Menubar contains File, View, Settings, and Help menus. </phrase>
        </textobject>
      </mediaobject>
    </screenshot>
      </figure>
    <!-- ==== End of Figure ==== -->

    <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
    <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->

    <para>The &app; window contains the following elements:
    </para>
      <variablelist>
    <varlistentry>
    <term>Menubar. </term>
    <listitem>
    <para>The menus on the menubar contain all of the commands you need to work with files in
    &app;.</para>
    </listitem>
    </varlistentry>
    <varlistentry>
    <term>Toolbar. </term>
    <listitem>
    <para> The toolbar contains a subset of the commands that you can access from the menubar.</para>
    </listitem>
    </varlistentry>
    <varlistentry>
    <term>Statusbar. </term>
    <listitem>
    <para>The statusbar displays information about current &app;
    activity and contextual information about the menu items. </para>
    </listitem>
    </varlistentry>
    </variablelist>
    </sect2>
  </sect1>
<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for which the application is designed.
     If this section runs to more than a few screens in Yelp, consider splitting it into several top-level sections.
  -->
  <sect1 id="myapp-usage">
    <title>Usage</title>
    <para>You can use the &app; application to
      perform the following tasks:
      <itemizedlist>
    <listitem>
      <para>
        <xref linkend="myapp-open-image"/></para>
    </listitem>
    <listitem>
      <para>
        <xref linkend="myapp-manipulate-view"/></para>
    </listitem>
    <listitem>
      <para>
        <xref linkend="myapp-scroll-image"/></para>
    </listitem>
    <listitem>
      <para>
        <xref linkend="myapp-close-image"/></para>
    </listitem>
      </itemizedlist> </para>
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="myapp-open-image">
      <title>Opening an Image</title>
      <para>To open an image, choose
    <menuchoice>
      <guimenu>File</guimenu>
      <guimenuitem>Open Image</guimenuitem>
    </menuchoice>. The
    <guilabel>Open Image</guilabel> dialog is displayed. Select the file
    that you want to open, then click
    <guibutton>OK</guibutton>. To open another image in a new window,
    choose
    <menuchoice>
      <guimenu>File</guimenu>
      <guimenuitem>Create New Window</guimenuitem>
    </menuchoice>. Choose
    <menuchoice>
      <guimenu>File</guimenu>
      <guimenuitem>Open Image</guimenuitem>
    </menuchoice>
    to select the file that you want to open. You can also drag an image
    from another application such as a file manager to the &app;
    window. If the &app; window is empty, the application displays
    the image in the window. If the window is not empty, the
    application starts a new window to display the file. The
    application displays the name of the image file and the size
    of the image in pixels in the titlebar of the window. </para>
      <para>
    If you try to open an image file format that &app; does
    not recognize, the application displays an error
    message.
      </para>
      <caution>
      <para>This is a caution.</para>
      </caution>
    </sect2>
    <!-- ================ Usage Subsection ================================ -->
     <sect2 id="myapp-manipulate-view">
      <title>Manipulating the View of an Image</title>
      <para>You can use the following methods to resize the view of an image in
    the &app; window:</para>
      <itemizedlist>
    <listitem>
      <para>To enlarge the view of an image, choose
        <menuchoice>
          <guimenu>View</guimenu>
          <guimenuitem>Zoom In</guimenuitem>
        </menuchoice>.</para>
    </listitem>
    <listitem>
      <para>To shrink the view of an image, choose
        <menuchoice>
          <guimenu>View</guimenu>
          <guimenuitem>Zoom Out</guimenuitem>
        </menuchoice>.</para>
    </listitem>
    <listitem>
      <para>To view the image at its actual size, choose
        <menuchoice>
          <guimenu>View</guimenu>
          <guimenuitem>Zoom 1:1</guimenuitem>
        </menuchoice>. </para>
    </listitem>
    <listitem>
      <para>To enlarge or shrink the view of an image so that the image
        fits the &app; window, choose
        <menuchoice>
          <guimenu>View</guimenu>
          <guimenuitem>Fit to Window</guimenuitem>
        </menuchoice>.</para>
    </listitem>
    <listitem>
      <para>To enlarge or shrink the image to a specific zoom factor,
        choose
        <menuchoice>
          <guimenu>View</guimenu>
          <guimenuitem>Zoom factor</guimenuitem>
        </menuchoice>, then choose the appropriate zoom factor from the
        drop-down list.</para>
    </listitem>
    <listitem>
      <para>To display the image in full screen mode, choose
        <menuchoice>
          <guimenu>View</guimenu>
          <guimenuitem>Full Screen</guimenuitem>
        </menuchoice>. Full screen mode displays the image in a window that
        fills the full screen. The window does not contain a
        window frame, titlebar,
        menubar, or toolbar. To exit from this mode, press the
        <keycap>Esc</keycap> key or
        <keycombo>
              <keycap>Ctrl</keycap>
          <keycap>W</keycap>
        </keycombo>.
      </para>
    </listitem>
      </itemizedlist>
      <tip>
      <para>This is a tip.</para>
      </tip>
    </sect2>
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="myapp-scroll-image">
      <title>Scrolling an Image</title>
      <para>To scroll around an image that is larger than the image window or
    full screen window, you can use the following methods:</para>
      <itemizedlist>
    <listitem>
      <para>Use the arrow keys on the keyboard.</para>
    </listitem>
    <listitem>
      <para>Drag the image in the opposite direction to the direction in
        which you want to scroll. For example, if you want to
          scroll down the image,
        drag the image upwards in the window.</para>
    </listitem>
    <listitem>
      <para>Use the scrollbars on the window.</para>
    </listitem>
      </itemizedlist>
    </sect2>
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="myapp-close-image">
      <title>Closing an Image</title>
      <para>To close an image, choose
    <menuchoice>
      <guimenu>File</guimenu>
      <guimenuitem>Close This Window</guimenuitem>
    </menuchoice>. If the window is the last
    &app; window open, the application exits. </para>
      <para>To quit &app; and close all of the
    windows that you opened in the current session, choose
    <menuchoice>
      <guimenu>File</guimenu>
      <guimenuitem>Exit</guimenuitem>
    </menuchoice>. </para>
      <warning>
      <para>This is a warning.</para>
      </warning>
    </sect2>
  </sect1>
  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="myapp-prefs">
    <title>Preferences</title>
    <para>To configure &app;, choose
      <menuchoice>
    <guimenu>Edit</guimenu>
    <guimenuitem>Preferences</guimenuitem>
      </menuchoice>. The
      <guilabel>Preferences</guilabel> dialog contains the following tabbed
      sections:</para>
    <itemizedlist>
      <listitem>
    <para>
      <xref linkend="myapp-prefs-display"/></para>
      </listitem>
      <listitem>
    <para>
      <xref linkend="myapp-prefs-viewers"/></para>
      </listitem>
    </itemizedlist>
<!-- =============== Customization Subsection ================ -->
<!-- Use a new section to describe different tabbed sections on the Preferences
         dialog. -->
    <sect2 id="myapp-prefs-display">
      <title>Display</title>
      <variablelist>
    <varlistentry>
      <term>
        <guilabel>Interpolation type</guilabel> </term>
      <listitem>
        <para>Use this drop-down list box to specify the
          interpolation method that
          &app; uses when the
          application resizes images. Select one of the following
          options:</para>
        <itemizedlist>
          <listitem>
        <para>
          <guilabel>Nearest neighbor</guilabel> </para>
        <para>This method of interpolation takes a location in the
          original image and replicates the pixel that is
          nearest to this location. When
          you zoom in on an image, the pixels are
          replicated. When you zoom out of an
          image, the image loses some of its detail. </para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Bilinear</guilabel> </para>
        <para>This is a simple and fast method of interpolation. When
          you zoom in on an image, &app; uses up to four
          adjacent pixels to compute the colors of the new
          pixels. When you zoom out of
          an image, &app; averages regions of color in the
          existing image to compute the colors of the pixels. </para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Hyperbolic</guilabel> </para>
        <para>This is a high-quality, slow method of interpolation. The
          application performs interpolation on the image in
          the manner described in
          Digital Image Warping by George Wolberg.</para>
          </listitem>
        </itemizedlist>
        <para>Default:
          <guilabel>Nearest neighbor</guilabel>.</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <guilabel>Transparency type</guilabel> </term>
      <listitem>
        <para>Use this drop-down list box to specify how
          &app; displays transparent or partially opaque
          backgrounds in images. Select one of the following options:</para>
        <itemizedlist>
          <listitem>
        <para>
          <guilabel>Dark checks</guilabel> </para>
        <para>This option displays black and dark gray checks.</para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Midtone checks</guilabel> </para>
        <para>This option displays dark gray and light gray
          checks.</para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Light checks</guilabel> </para>
        <para>This option displays light gray and white checks.</para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Black only</guilabel> </para>
        <para>This option displays solid black.</para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Gray only</guilabel> </para>
        <para>This option displays solid gray.</para>
          </listitem>
          <listitem>
        <para>
          <guilabel>White only</guilabel> </para>
        <para>This option displays solid white.</para>
          </listitem>
        </itemizedlist>
        <para>Default:
          <guilabel>Dark checks</guilabel>.</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <guilabel>Check size</guilabel> </term>
      <listitem>
        <para>Use this drop-down list box to specify the size of the checks
          to use to display transparent or partially opaque
          backgrounds in images. This
          option is only relevant if you choose
          <guilabel>Dark checks</guilabel>,
          <guilabel>Midtone checks</guilabel>, or
          <guilabel>Light checks</guilabel> from the
          <guilabel>Transparency type</guilabel> drop-down list box.
          Select one of the following options:</para>
        <itemizedlist>
          <listitem>
        <para>
          <guilabel>Small</guilabel></para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Medium</guilabel></para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Large</guilabel></para>
          </listitem>
        </itemizedlist>
        <para>Default:
          <guilabel>Small</guilabel>.</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <guilabel>Dither type</guilabel> </term>
      <listitem>
        <para>Use this drop-down list box to specify the dithering method
          to use to display images. Dithering is a technique that
          is used to simulate
          colors in the original image file but that your system
          can not display. Select
          one of the following options:</para>
        <itemizedlist>
          <listitem>
        <para>
          <guilabel>None</guilabel> </para>
        <para>This option does not use dithering. </para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Normal (pseudocolor)</guilabel> </para>
        <para>This option performs dithering on pseudocolor displays,
          which use a limited palette of colors. </para>
          </listitem>
          <listitem>
        <para>
          <guilabel>Maximum (high color)</guilabel> </para>
        <para>This option performs dithering on pseudocolor and high
          color displays. </para>
          </listitem>
        </itemizedlist>
        <para>Default:
          <guilabel>None</guilabel>.</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <guilabel>Two-pass scrolling</guilabel> </term>
      <listitem>
        <para>Select this option to render an image in two passes
          when you scroll the image quickly. The first pass
          renders a low quality version of the image. The second
          pass renders a full quality version of the image over
          the low quality version. Two-pass scrolling enables you
          to view at least a low quality version of the image at
          all times regardless of how quickly you scroll the
          image.
        </para>
        <para>Default: unselected.</para>
      </listitem>
    </varlistentry>
      </variablelist>
    </sect2>
    <!-- ============= Customization Subsection ===================== -->
    <!-- Another tabbed section on the Preferences dialog. -->
    <sect2 id="myapp-prefs-viewers">
      <title>Viewers</title>
      <para>You can set the following viewer preferences:
    <itemizedlist>
      <listitem>
        <para>
          <xref linkend="myapp-viewer-prefs-image-window"/></para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="myapp-viewer-prefs-full-screen"/></para>
      </listitem>
    </itemizedlist> </para>
      <sect3 id="myapp-viewer-prefs-image-window">
    <title>Image Windows</title>
    <para>The
      <guilabel>Image Windows</guilabel> group contains the preferences
      that you can set to view images in image windows.</para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Use scrollbars</guilabel> </term>
        <listitem>
          <para>Use this drop-down list box to specify when to use
        scrollbars to scroll through an image. Select one of
        the following options:</para>
          <itemizedlist>
        <listitem>
          <para>
            <guilabel>Never</guilabel> </para>
          <para>This option never displays scrollbars. You can use the
            arrow keys on the keyboard or the mouse to scroll
            through the image. </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Only if image does not fit</guilabel> </para>
          <para>This option displays scrollbars when the image is
            larger than the image window.</para>
        </listitem>
          </itemizedlist>
          <para>Default:
        <guilabel>Never</guilabel>.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Pick window size and zoom factor
        automatically</guilabel> </term>
        <listitem>
          <para>Select this option to resize the image window to fit the
        image or to resize the image to fit the image
        window. If the image is small,
        &app; resizes the image window to fit the image. If
        the image is large, &app; resizes the image to fit
        the image window. </para>
          <para>Default: unselected.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Open images in a new window</guilabel> </term>
        <listitem>
          <para>Select this option to open a new
        &app; window each time you open an image. If you do
        not select this option, &app; replaces the existing
        image with the new image when you open an image. </para>
          <para>Default: unselected.</para>
        </listitem>
      </varlistentry>
    </variablelist>
      </sect3>
      <sect3 id="myapp-viewer-prefs-full-screen">
    <title>Full Screen</title>
    <para>The
      <guilabel>Full Screen</guilabel> group contains the preferences that
      you can set to view images in full screen mode.</para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Use scrollbars</guilabel> </term>
        <listitem>
          <para>Use this drop-down list box to specify when to use
        scrollbars to scroll through an image. Select one of the following
        options:</para>
          <itemizedlist>
        <listitem>
          <para>
            <guilabel>Never</guilabel> </para>
          <para>This option never displays scrollbars. You can use the
            arrow keys on the keyboard or the mouse to scroll
            through the image. </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Only if image does not fit</guilabel> </para>
          <para>This option displays scrollbars when the image is
            larger than the full screen. </para>
        </listitem>
          </itemizedlist>
          <para>Default:
        <guilabel>Never</guilabel>.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Use 1:1 zoom factor</guilabel> </term>
        <listitem>
          <para>Select this option to use the 1:1 zoom factor when you open
        an image. The 1:1 zoom factor displays the image at
        its actual size. </para>
          <para>Default: selected.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Use same zoom factor as image window</guilabel> </term>

        <listitem>
          <para>Select this option to use the same zoom factor that the
        application uses to display the image in an image
          window. </para>
          <para>Default: unselected.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Fit all images to screen</guilabel> </term>
        <listitem>
          <para>Select this option to resize images to fill the full screen
        when you open the images in full screen mode. </para>
          <para>Default: unselected.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Fit standard-sized images to screen</guilabel> </term>
        <listitem>
          <para>Select this option to automatically resize images
        that are the same size as standard screens so that the
        images fill the full screen when you open them in full
        screen mode. If you select this option, &app; ignores
        the settings for the previous three options when you
        open an image that is the same size as a standard
        screen.  Examples of standard screen sizes are 640 x
        480 pixels, 1024 x 768 pixels, and so on. </para>
          <para>Default: unselected.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Put a bevel around the edge of the screen</guilabel>
        </term>
        <listitem>
          <para>Select this option to display a 3D beveled border around
        the full screen view of an image. </para>
          <para>Default: unselected.</para>
        </listitem>
      </varlistentry>
    </variablelist>
      </sect3>
    </sect2>
  </sect1>
<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default.
     You can use it to describe known bugs and limitations of the
      program if there are any - please be frank and list all
     problems you know of.

  <sect1 id="mayapp-bugs">
  <title>Known Bugs and Limitations</title>
  <para> </para>
 </sect1>
-->
<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  <sect1 id="myapp-about">
    <title>About &app;</title>
    <para> &app; was written by GNOME-HACKER
      (<email>[e-mail]</email>). To find more information about
      &app;, please visit the
      <ulink url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
    page</ulink>. </para>
    <para>
      To report a bug or make a suggestion regarding this application or
      this manual, follow the directions in the
      <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the GNOME User Guide</ulink>.
    </para>

    <para> This program is distributed under the terms of the GNU
      General Public license as published by the Free Software
      Foundation; either version 2 of the License, or (at your option)
      any later version. A
      <ulink url="ghelp:gpl" type="help">copy of this license</ulink>
      is included with this documentation; another can be found in the file
      COPYING included with the source code of this program. </para>

  </sect1>
</article>